<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      install-tl-unx
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-9.1">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 9.1
      </h4>
      <h3>
        Chapter&nbsp;51.&nbsp;Typesetting
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="tex-path.html" title=
          "Setting the PATH for TeX Live">Prev</a>
          <p>
            Setting the PATH for TeX Live
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="texlive.html" title=
          "texlive-20190410-source">Next</a>
          <p>
            texlive-20190410-source
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="typesetting.html" title=
          "Chapter&nbsp;51.&nbsp;Typesetting">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="tl-installer" name="tl-installer"></a>install-tl-unx
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to TeX Live and its installer
        </h2>
        <p>
          The <span class="application">TeX Live</span> package is a
          comprehensive TeX document production system. It includes TeX,
          LaTeX2e, ConTeXt, Metafont, MetaPost, BibTeX and many other
          programs; an extensive collection of macros, fonts and
          documentation; and support for typesetting in many different
          scripts from around the world.
        </p>
        <p>
          This page is for people who wish to use the binary installer to
          provide the programs, the scripts, and a lot of supporting files
          and documentation. The installer is updated frequently, so its
          md5sum will change if it is newer than what is shown below. Newer
          versions of the installer are expected to work with these
          instructions, for so long as they install to a <code class=
          "filename">2019/</code> directory.
        </p>
        <p>
          There are two reasons why you may wish to install the binaries in
          BLFS: either you need a smaller install (e.g. at a minimum plain
          TeX without LaTeX2e, ConTeXt, etc), or you wish to use <span class=
          "command"><strong>tlmgr</strong></span> to get updates whilst this
          version is supported (typically, until April of the year after it
          was released). For the latter, you might prefer to install in your
          <code class="filename">/home</code> directory as an unprivileged
          user, and to then make corresponding changes to the PATH in your
          <code class="filename">~/.bashrc</code> or equivalent.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz">
                http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: e80f92667fb65f38dae88d1c5b22dba3 (for
                20190529)
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 3.8 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 6.7 GB if everything is
                included
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: varies, depending on network speed and
                traffic
              </p>
            </li>
          </ul>
        </div>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="../postlfs/gnupg.html" title=
          "GnuPG-2.2.19">GnuPG-2.2.19</a> (to validate both the initial
          downloads, and also any updates you might later make using
          <span class="command"><strong>tlmgr</strong></span>.)
        </p>
        <h4>
          Recommended (at runtime)
        </h4>
        <p class="recommended">
          The binaries are mostly linked to included static libraries or
          general (LFS) system libraries, but a few of the programs and
          several scripts will fail if the following packages are not
          present:
        </p>
        <p class="recommended">
          <a class="xref" href="gs.html" title=
          "ghostscript-9.50">ghostscript-9.50</a> is dynamically loaded by
          the external application <a class="ulink" href=
          "https://dvisvgm.de/">dvisvgm</a>, which is used by <span class=
          "application">asy</span> when that creates SVG files.
        </p>
        <p class="recommended">
          <a class="xref" href="../x/x7lib.html" title="Xorg Libraries">Xorg
          Libraries</a> and <a class="xref" href="../x/libxcb.html" title=
          "libxcb-1.13.1">libxcb-1.13.1</a> are needed for inimf, mf,
          pdfclose, pdfopen and xdvi-xaw. But if you are using asy, or using
          a <span class="application">TeX</span> engine to create a PDF file,
          you will need an <a class="xref" href="../x/installing.html" title=
          "Chapter&nbsp;24.&nbsp;X Window System Environment">X Window
          System</a> (for PDF files, this is to support a PDF viewer of your
          choice, for example <a class="xref" href="epdfview.html" title=
          "ePDFView-0.1.8">epdfview-0.1.8</a>).
        </p>
        <p class="recommended">
          the optional non-wide-character ncurses library (for "some
          binary-only application") from the bottom of the <span class=
          "application">Ncurses</span> page in LFS is needed for xindy.run
          which is used by <span class="application">xindy</span>
        </p>
        <p class="recommended">
          The binary version of <span class="application">asy</span> needs
          <a class="xref" href="../x/freeglut.html" title=
          "Freeglut-3.2.1">Freeglut-3.2.1</a>.
        </p>
        <p>
          As always with contributed binary software, it is possible that the
          required dependencies may change when the installer is updated. In
          particular, these dependencies have only been checked on x86_64.
        </p>
        <p class="recommended">
          <a class="xref" href="../general/python2.html" title=
          "Python-2.7.17">Python-2.7.17</a> is used by many scripts.
          <a class="xref" href="../general/ruby.html" title=
          "Ruby-2.7.0">Ruby-2.7.0</a> is used by some scripts, mostly within
          mtx_context which is part of <span class=
          "application">conTeXt</span>, but also for one or two others, such
          as match_parens, which are generally useful. The perl module
          <a class="ulink" href=
          "https://cpan.metacpan.org/authors/id/S/SR/SREZIC/Tk-804.034.tar.gz">
          Tk</a>, which requires <a class="xref" href="../general/tk.html"
          title="Tk-8.6.10">Tk-8.6.10</a>, is used by one of the scripts for
          ptex (Japanese vertical writing), can be used by a conTeXt texfind
          script, and is needed for texdoctk (a GUI interface for finding
          documentation files and opening them with the appropriate viewer).
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/tl-installer">http://wiki.linuxfromscratch.org/blfs/wiki/tl-installer</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Binary Installation of TeX Live
        </h2>
        <p>
          The <span class="application">TeX Live</span> set of programs with
          its supporting documents, fonts, and utilities is very large. The
          upstream maintainers recommend placing all files in a single
          directory structure. BLFS recommends <code class=
          "filename">/opt/texlive</code>.
        </p>
        <p>
          As with any other package, unpack the installer and change into its
          directory, <code class=
          "filename">install-tl-&lt;CCYYMMDD&gt;</code>. This directory name
          changes when the installer is updated, so replace &lt;CCYYMMDD&gt;
          by the correct directory name.
        </p>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            The distribution binaries installed below may use static linking
            for general linux system libraries. Additional libraries or
            interpreters as specified in the dependencies section do not need
            to be present during the install, but the programs that need them
            will not run until their specific dependencies have been
            installed.
          </p>
          <p>
            With all contributed binary software, there may be a mismatch
            between the builder's toolchain and your hardware. In most of TeX
            this will probably not matter, but in uncommon corner cases you
            might hit problems. e.g. if your x86_64 processor does not
            support 3dnowext or 3dnow, the 2014-06-28 binary failed in
            conTeXt when running LuaTeX, although lualatex worked, as did the
            i686 binaries on the same machine. In such cases, the easiest
            solution is to install texlive from source. Similarly, the x86_64
            binary version of <span class=
            "command"><strong>asy</strong></span> runs very slowly when
            creating 3-D diagrams.
          </p>
        </div>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</kbd>
</pre>
        <p>
          This command is interactive and allows selection or modification of
          platform, packages, directories, and other options. The full
          installation scheme will require about 4.9 gigabytes of disk space.
          The time to complete the download will depend on your internet
          connection speed and the number of packages selected.
        </p>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <code class="option">./install-tl --location
          http://mirror.aut.ac.nz/CTAN/systems/texlive/tlnet/</code>: use a
          variation of this if you wish to use a different mirror, e.g.
          because you are in New Zealand but the installer chooses to use an
          Australian mirror. The list of mirrors is at
          http://ctan.org/mirrors.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">Over 300 binaries and symlinks to
              scripts</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">None</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/opt/texlive</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="tl-installer-programs" name=
                    "tl-installer-programs"></a><span class=
                    "term"><span class=
                    "command"><strong>TeX&nbsp;programs</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    The programs included in <span class=
                    "application">TeX</span> are too numerous to individually
                    list. Please refer to the individual program HTML and PDF
                    pages in the various html, man, or pdf files within the
                    subdirectories of <code class=
                    "filename">2019/texmf-dist/</code>. Using <span class=
                    "command"><strong>texdoc pdflatex</strong></span> (
                    replace <span class="emphasis"><em>pdflatex</em></span>
                    with the command name ) may also be useful.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-02-22 11:34:16 -0800
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="tex-path.html" title=
          "Setting the PATH for TeX Live">Prev</a>
          <p>
            Setting the PATH for TeX Live
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="texlive.html" title=
          "texlive-20190410-source">Next</a>
          <p>
            texlive-20190410-source
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="typesetting.html" title=
          "Chapter&nbsp;51.&nbsp;Typesetting">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
